Skip to content

feat(ui): 运行结束态展示 stop_reason 并修正取消被显示为已完成 - #425

Open
lhy-dcf wants to merge 2 commits into
helsome:mainfrom
lhy-dcf:feat/ui-stop-reason-display
Open

lhy-dcf wants to merge 2 commits into
helsome:mainfrom
lhy-dcf:feat/ui-stop-reason-display

Conversation

@lhy-dcf

@lhy-dcf lhy-dcf commented Nov 20, 2026

Copy link
Copy Markdown
Contributor

改动说明

接线上游 #17「维护进度更新」中列出的剩余缺口之一:UI 展示 stopReason / stopDetail,让用户看到 run 为什么停止。当前 main 上存在两个具体问题:

  1. guard stop 的原因在 UI 上不可见:RunManager 的 safeguard stop(fix(runtime): replay #49 run-budget wiring onto clean main #54 接线的预算/循环/重试风暴)把 stopReason 写在持久化的 Run 记录上,但事件流的 run_failed code 恒为 RUN_CANCELLED(pi-event-adapter.ts:126、local-runtime-adapter.ts:67),事件驱动的 footer 投影永远拿不到停止原因——GUARD_STOP_CODES 的提取路径实际不可达。
  2. cancelled run 被显示成「已完成」:RunFooter 的三分支文案里没有 cancelled 分支,status === 'cancelled' 且非 guard 停止的 run 落入 trace.footer.completed。

修复:

  • RunFooter 回读持久化记录:run 结束后通过 kernel.listRuns() 取该 run 的 stopReason / stopDetail,guard 停止(budget_exhausted / loop_detected / retry_storm)渲染既有 trace.footer.stopped 文案;事件投影携带的 guard stop(若有)优先。
  • 新增 cancelled 文案:用户取消的 run 显示 trace.footer.cancelled(en: Cancelled · {{tools}} tools / zh: 已取消 · {{tools}} 个工具),不再误报完成;中性样式(取消不是错误),guard stop 与 failed 保持红色样式。
  • 重试风暴证据格式化:formatStopDetail 支持 retry_storm 的 retriesInWindow( · N retries);GuardStopDetail 补充该可选字段。
  • i18n en-US / zh-CN 同步(bun run i18n:check 1558 keys parity 通过)。

不修改运行时预算算法;observeRetry 的运行时接线见 #424。无其他可见 UI 变化(footer 在正常 completed 场景的文案与样式不变,有组件测试钉住)。

关联 Issue

Related to #17(本 PR 补全维护者列出的 UI 展示缺口;observeRetry 运行时接线见 #424。两个缺口都落地后 #17 的验收清单仅剩真实 provider 的 retry-storm run——检测器语义由单测覆盖,#49 已交付的低预算与重复调用 E2E 不受本 PR 影响)

测试报告(正式审核前必填)

环境

  • Bun:1.4.2
  • OS:Windows 11(10.0.26100 x64)

实际执行命令与结果

bun test packages/ui/src/components/agent/RunFooter.test.tsx
→ 5 passed / 0 failed
  (纯取消显示 Cancelled 不显示 Completed;持久化 budget_exhausted 渲染
   "Stopped early · budget exhausted · 2 tools · modelCalls 1/1";
   retry_storm 渲染 "too many retries · 3 retries";事件投影携带的
   guard stop 优先于记录回读;正常 completed footer 不受影响)

bun test packages/ui
→ 473 passed / 2 failed
→ 失败说明:未改动的 upstream/main(e42e927)在本机同样这 2 个失败
  (money.test.ts 的 currencyForSymbol 与 PortfolioSection 的 locale 用例,
  跨文件顺序污染,与本 PR 无关;本分支新增 5 条测试全部通过)。

bun run typecheck
→ core / i18n / shared / ui / electron 全部 exit 0

bun run i18n:check
→ en-US 1558 keys ≡ zh-CN 1558 keys,0 issues

截图(demo/local 模式:FINAGENT_AGENT_PROVIDER=local + FINAGENT_DEMO_DATA=1,取消场景的 After 与修复前 Before)随后以评论附上。

- RunFooter 在 run 结束后回读持久化 Run 记录的 stopReason/stopDetail:
  guard stop(预算/循环/重试风暴)的事件流 code 恒为 RUN_CANCELLED,
  事件投影层拿不到停止原因,只有 Run 记录上有;
- guard 停止显示既有 stopped 文案(stopReasons 子键),重试风暴补充
  retriesInWindow 证据格式化;用户取消显示新的 cancelled 文案——
  此前 cancelled run 会落入 completed 分支,被显示成「已完成」;
- i18n en/zh 新增 trace.footer.cancelled;GuardStopDetail 增加
  retriesInWindow 可选字段;
- RunFooter 导出并新增 5 条组件测试(纯取消、持久化预算停止、
  重试风暴证据、事件投影优先于记录、正常完成不受影响)。
- Before:修复前,取消的 run 在 footer 显示「Completed · 0.1s · 0 steps」;
- After:修复后,同一取消操作显示「Cancelled · 0 tools」;
- 场景:FINAGENT_AGENT_PROVIDER=local + FINAGENT_DEMO_DATA=1,
  发送报价问题后在 Stop 可点窗口内取消(local runtime 加了 4s 演示延迟
  以便人工取消,该延迟只存在于截图脚本环境,不在本 PR diff 中)。
@lhy-dcf

lhy-dcf commented Nov 21, 2026

Copy link
Copy Markdown
Contributor Author

截图补充(demo/local 模式:FINAGENT_AGENT_PROVIDER=local + FINAGENT_DEMO_DATA=1)

同一操作序列(发送报价问题 → 在 Stop 可点窗口内取消):

Before(修复前,取消的 run 被显示成「已完成」)

before

After(修复后,footer 显示「Cancelled · 0 tools」,中性样式,不再误报完成)

after

复现说明:取消由点击 Stop 按钮触发(cancelRun → RUN_CANCELLED,持久化记录 status=cancelled);由于 demo/local runtime 确定性秒级完成,为让人工来得及点 Stop,截图环境的 local runtime 加了 4 秒延迟——该延迟只存在于截图脚本环境,不在本 PR diff 中(docs/screenshots/pr-425/ 仅包含两张 PNG)。无其他可见 UI 变化。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant